BlueCielo Meridian Enterprise 2016 VBScript API Reference

Understanding the CurrentPropertyName property

Many configuration expressions only affect the current property and therefore are limited in what they can do in a single statement, particularly with respect to other properties and objects. This is adequate for most customization but can be inadequate for advanced customization. In such situations, the programmer must usually define a separate function to perform the necessary actions and call that function from the configuration expression. The function is often a common one that is called from multiple configuration expressions. However, determining the context that the function is running in can then require much code. The CurrentPropertyName property helps with this.

The CurrentPropertyName property is globally available. That is, it is independent from the current configuration expression but it is always related to the current property that is affected by the calling expression.

The CurrentPropertyName property is available from the following property definition options:

• On the Assignment tab:
  • Condition option
  • Assignment option
• On the Validation tab:
  • In the Input required group, the This expression must be True option.
  • In the Select a value group, the This expression option.
  • In the Apply input restrictions group, the This expression must be True option.

The CurrentPropertyName property is available from the following property panel options:

• On the Fields tab:
  • Set visibility expression option
  • Set read-only expression option

For example, in a scenario where the properties that require input vary depending on the user's group memberships, the configuration expressions of all of the affected properties could contain an expression like IsPropertyRequired("SomeProperty") where IsPropertyRequired is a custom function and the property name that is passed to the function is specified in each expression. Except for the property name, the same expression is used for every property. Within the IsPropertyRequired function, a Select statement or similar construct can compare the property name that is passed with logic to fetch the user's group memberships and return True or False depending on the organization's business rules.

By using the CurrentPropertyName property, the expression can be simplified to eliminate the property name. The IsPropertyRequired function can retrieve the current property name from the CurrentPropertyName property. The rest of the function definition could work the same as before.